home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Archives / ForCLI / multibox.lha / MultiBox / MultiBox.doc < prev    next >
Encoding:
Text File  |  1992-07-03  |  1.8 KB  |  66 lines
  1. -------------------------------------------------------------------------------
  2.  
  3.                              MultiBox (Kick >2.04 only!)
  4.  
  5. -------------------------------------------------------------------------------
  6.  
  7. (c) 1992 by Michael Watzl
  8.     freely distributable
  9.  
  10. This little program is freeware, you can copy it as long as you don't make any
  11. profit.
  12.  
  13. I often use neat tools like "Requester" (from Stefan Sticht, AmigaLibDisk 497)
  14. or others. But sometimes you have to click more than one gadget at one time
  15. e.g. if you want to ask for some options in a script. And this is exactly what
  16. multibox does:
  17.  
  18. You can select multiple choices and then click OK (or press RETURN). Multibox
  19. then returns a value indicating which option has been set and which not.
  20.  
  21. Syntax:
  22.  
  23. multibox [HAIL hailstring] TITLE titlestring BOXES Box1|Box2...
  24.  
  25.  
  26. hailstring          optional
  27.  
  28. titlestring         contains the question for the user
  29.  
  30. Box1, Box2,...      strings for the CHECKBOX gadgets
  31.                     look in the example scripts!
  32.  
  33. A gadget can be made checked by default, if you add a '_' to the string
  34. (e.g. ... BOXES FFS|NOICONS_ ).
  35.  
  36. Structure of the return code:
  37.  
  38. EXAMPLE
  39.  
  40. CHECKBOX-Nr.      "CHECKSTATUS"       VALUE
  41.  
  42.     1                  ON              1 * 2^0
  43.     2                  OFF             0 * 2^1
  44.     3                  ON              1 * 2^2
  45.     4                  ON              1 * 2^3
  46. -----------------------------------------------
  47. RETURN CODE:                          15
  48.  
  49. YOU MUST SET THE FAILAT VALUE TO 65537 BEFORE; OR YOUR SCRIPT MAY BREAK!
  50.  
  51. Beware: If you press cancel, the RC will be 65536!
  52.  
  53. Look into the example scripts how to decode this from within a scrtipt.
  54.  
  55. That's all
  56. --------------------------------------------------------------------------
  57.  
  58. Michael Watzl
  59. Konradstr. 11
  60. 8850 Donauwoerth
  61.  
  62. GERMANY
  63.  
  64.  
  65. Support shareware!
  66.